Eclipse Platform
Pre-release 3.0

org.eclipse.jface.text.contentassist
Class ContentAssistant

java.lang.Object
  extended byorg.eclipse.jface.text.contentassist.ContentAssistant
All Implemented Interfaces:
IContentAssistant, IContentAssistantExtension, IWidgetTokenKeeper, IWidgetTokenKeeperExtension

public class ContentAssistant
extends Object
implements IContentAssistant, IContentAssistantExtension, IWidgetTokenKeeper, IWidgetTokenKeeperExtension

The standard implementation of the IContentAssistant interface. Usually, clients instantiate this class and configure it before using it.


Field Summary
static int WIDGET_PRIORITY
          The popup priority: > linked position proposals and hover popups.
 
Fields inherited from interface org.eclipse.jface.text.contentassist.IContentAssistant
CONTEXT_INFO_ABOVE, CONTEXT_INFO_BELOW, PROPOSAL_OVERLAY, PROPOSAL_REMOVE, PROPOSAL_STACKED
 
Constructor Summary
ContentAssistant()
          Creates a new content assistant.
 
Method Summary
 String completePrefix()
          Complete the common prefix of the available choices.
protected  void contextInformationClosed()
          Callback to signal this content assistant that the presentation of the context information has been stopped.
 void enableAutoActivation(boolean enabled)
          Enables the content assistant's auto activation mode.
 void enableAutoInsert(boolean enabled)
          Enables the content assistant's auto insertion mode.
 IContentAssistProcessor getContentAssistProcessor(String contentType)
          Returns the content assist processor to be used for the given content type.
 String getDocumentPartitioning()
          Returns the document partitioning this content assistant is using.
protected  void hide()
          Hides any open popups.
protected  void install()
           
 void install(IContentAssistSubject contentAssistSubject)
          Installs content assist support on the given subject.
 void install(ITextViewer textViewer)
          Installs content assist support on the given text viewer.
protected  void possibleCompletionsClosed()
          Callback to signal this content assistant that the presentation of the possible completions has been stopped.
 boolean requestWidgetToken(IWidgetTokenOwner owner)
          The given widget token owner requests the widget token from this token keeper.
 boolean requestWidgetToken(IWidgetTokenOwner owner, int priority)
          The given widget token owner requests the widget token from this token keeper.
 void setAutoActivationDelay(int delay)
          Sets the delay after which the content assistant is automatically invoked if the cursor is behind an auto activation character.
 void setContentAssistProcessor(IContentAssistProcessor processor, String contentType)
          Registers a given content assist processor for a particular content type.
 void setContextInformationPopupBackground(Color background)
          Sets the context information popup's background color.
 void setContextInformationPopupForeground(Color foreground)
          Sets the context information popup's foreground color.
 void setContextInformationPopupOrientation(int orientation)
          Sets the context information popup's orientation.
 void setContextSelectorBackground(Color background)
          Sets the context selector's background color.
 void setContextSelectorForeground(Color foreground)
          Sets the context selector's foreground color.
 void setDocumentPartitioning(String partitioning)
          Sets the document partitioning this content assistant is using.
 boolean setFocus(IWidgetTokenOwner owner)
          Requests the receiver to give focus to its popup shell, hover, or similar.
 void setInformationControlCreator(IInformationControlCreator creator)
          Sets the information control creator for the additional information control.
 void setProposalPopupOrientation(int orientation)
          Sets the proposal popups' orientation.
 void setProposalSelectorBackground(Color background)
          Sets the proposal selector's background color.
 void setProposalSelectorForeground(Color foreground)
          Sets the proposal's foreground color.
 String showContextInformation()
          Shows context information for the content at the viewer's cursor position.
 String showPossibleCompletions()
          Shows all possible completions of the content at the viewer's cursor position.
 void uninstall()
          Uninstalls content assist support from the text viewer it has previously be installed on.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

WIDGET_PRIORITY

public static final int WIDGET_PRIORITY
The popup priority: > linked position proposals and hover popups. Default value: 20;

Since:
3.0
See Also:
Constant Field Values
Constructor Detail

ContentAssistant

public ContentAssistant()
Creates a new content assistant. The content assistant is not automatically activated, overlays the completion proposals with context information list if necessary, and shows the context information above the location at which it was activated. If auto activation will be enabled, without further configuration steps, this content assistant is activated after a 500 ms delay. It uses the default partitioning.

Method Detail

setDocumentPartitioning

public void setDocumentPartitioning(String partitioning)
Sets the document partitioning this content assistant is using.

Parameters:
partitioning - the document partitioning for this content assistant

getDocumentPartitioning

public String getDocumentPartitioning()
Description copied from interface: IContentAssistantExtension
Returns the document partitioning this content assistant is using.

Specified by:
getDocumentPartitioning in interface IContentAssistantExtension
Returns:
the document partitioning this content assistant is using

setContentAssistProcessor

public void setContentAssistProcessor(IContentAssistProcessor processor,
                                      String contentType)
Registers a given content assist processor for a particular content type. If there is already a processor registered for this type, the new processor is registered instead of the old one.

Parameters:
processor - the content assist processor to register, or null to remove an existing one
contentType - the content type under which to register

getContentAssistProcessor

public IContentAssistProcessor getContentAssistProcessor(String contentType)
Description copied from interface: IContentAssistant
Returns the content assist processor to be used for the given content type.

Specified by:
getContentAssistProcessor in interface IContentAssistant
Parameters:
contentType - the type of the content for which this content assistant is to be requested
Returns:
an instance content assist processor or null if none exists for the specified content type

enableAutoActivation

public void enableAutoActivation(boolean enabled)
Enables the content assistant's auto activation mode.

Parameters:
enabled - indicates whether auto activation is enabled or not

enableAutoInsert

public void enableAutoInsert(boolean enabled)
Enables the content assistant's auto insertion mode. If enabled, the content assistant inserts a proposal automatically if it is the only proposal. In the case of ambiguities, the user must make the choice.

Parameters:
enabled - indicates whether auto insertion is enabled or not
Since:
2.0

setAutoActivationDelay

public void setAutoActivationDelay(int delay)
Sets the delay after which the content assistant is automatically invoked if the cursor is behind an auto activation character.

Parameters:
delay - the auto activation delay

setProposalPopupOrientation

public void setProposalPopupOrientation(int orientation)
Sets the proposal popups' orientation. The following values may be used:

Parameters:
orientation - the popup's orientation

setContextInformationPopupOrientation

public void setContextInformationPopupOrientation(int orientation)
Sets the context information popup's orientation. The following values may be used:

Parameters:
orientation - the popup's orientation

setContextInformationPopupBackground

public void setContextInformationPopupBackground(Color background)
Sets the context information popup's background color.

Parameters:
background - the background color

setContextInformationPopupForeground

public void setContextInformationPopupForeground(Color foreground)
Sets the context information popup's foreground color.

Parameters:
foreground - the foreground color
Since:
2.0

setProposalSelectorBackground

public void setProposalSelectorBackground(Color background)
Sets the proposal selector's background color.

Parameters:
background - the background color
Since:
2.0

setProposalSelectorForeground

public void setProposalSelectorForeground(Color foreground)
Sets the proposal's foreground color.

Parameters:
foreground - the foreground color
Since:
2.0

setContextSelectorBackground

public void setContextSelectorBackground(Color background)
Sets the context selector's background color.

Parameters:
background - the background color
Since:
2.0

setContextSelectorForeground

public void setContextSelectorForeground(Color foreground)
Sets the context selector's foreground color.

Parameters:
foreground - the foreground color
Since:
2.0

setInformationControlCreator

public void setInformationControlCreator(IInformationControlCreator creator)
Sets the information control creator for the additional information control.

Parameters:
creator - the information control creator for the additional information control
Since:
2.0

install

public void install(IContentAssistSubject contentAssistSubject)
Description copied from interface: IContentAssistantExtension
Installs content assist support on the given subject.

XXX: This is work in progress and can change anytime until API for 3.0 is frozen.

Specified by:
install in interface IContentAssistantExtension
Parameters:
contentAssistSubject - the one who requests content assist

install

public void install(ITextViewer textViewer)
Description copied from interface: IContentAssistant
Installs content assist support on the given text viewer.

Specified by:
install in interface IContentAssistant
Parameters:
textViewer - the text viewer on which content assist will work

install

protected void install()

uninstall

public void uninstall()
Description copied from interface: IContentAssistant
Uninstalls content assist support from the text viewer it has previously be installed on.

Specified by:
uninstall in interface IContentAssistant

showPossibleCompletions

public String showPossibleCompletions()
Description copied from interface: IContentAssistant
Shows all possible completions of the content at the viewer's cursor position.

Specified by:
showPossibleCompletions in interface IContentAssistant
Returns:
an optional error message if no proposals can be computed

completePrefix

public String completePrefix()
Description copied from interface: IContentAssistantExtension
Complete the common prefix of the available choices.

Specified by:
completePrefix in interface IContentAssistantExtension
Returns:
an optional error message if no proposals can be computed

possibleCompletionsClosed

protected void possibleCompletionsClosed()
Callback to signal this content assistant that the presentation of the possible completions has been stopped.

Since:
2.1

showContextInformation

public String showContextInformation()
Description copied from interface: IContentAssistant
Shows context information for the content at the viewer's cursor position.

Specified by:
showContextInformation in interface IContentAssistant
Returns:
an optional error message if no context information can be computed

contextInformationClosed

protected void contextInformationClosed()
Callback to signal this content assistant that the presentation of the context information has been stopped.

Since:
2.1

requestWidgetToken

public boolean requestWidgetToken(IWidgetTokenOwner owner)
Description copied from interface: IWidgetTokenKeeper
The given widget token owner requests the widget token from this token keeper. Returns true if the token is released by this token keeper. Note, the keeper must not call releaseWidgetToken(IWidgetTokenKeeper) explicitly.

Specified by:
requestWidgetToken in interface IWidgetTokenKeeper
Parameters:
owner - the token owner
Returns:
true if token has been released false otherwise

requestWidgetToken

public boolean requestWidgetToken(IWidgetTokenOwner owner,
                                  int priority)
Description copied from interface: IWidgetTokenKeeperExtension
The given widget token owner requests the widget token from this token keeper. Returns true if the token is released by this token keeper. Note, the keeper must not call releaseWidgetToken(IWidgetTokenKeeper) explicitly.

The general contract is that the receiver should release the token if priority exceeds the receiver's priority.

Specified by:
requestWidgetToken in interface IWidgetTokenKeeperExtension
Parameters:
owner - the token owner
priority - the priority of the request
Returns:
true if token has been released false otherwise

setFocus

public boolean setFocus(IWidgetTokenOwner owner)
Description copied from interface: IWidgetTokenKeeperExtension
Requests the receiver to give focus to its popup shell, hover, or similar. There is no assumption made whether the receiver actually succeeded in taking the focus. The return value gives a hint whether the receiver tried to take focus.

Specified by:
setFocus in interface IWidgetTokenKeeperExtension
Parameters:
owner - the token owner
Returns:
true if the receiver tried to take focus, false if it did not.

hide

protected void hide()
Hides any open popups.


Eclipse Platform
Pre-release 3.0

Copyright (c) IBM Corp. and others 2000, 2003. All Rights Reserved.